Copyright ｩ1998 by Hide Itoh <hide@kagi.com>. All Rights Reserved.
<http://www.vcnet.com/hide/download/>
What is iTrashMaker ?
iTrashMaker is a small program to help you create a system extension that replace the standard
trash icons with your custom icons.
ﾊ
This program is intended for the user who are familiar with ResEdit and who know how to edit icon resources with ResEdit. Therefore, this program have neither nice interface nor complete error checking. Please read this document completely without skipping any part first.
Besides, this program is a PPC application and designed for the PPC Mac that has Mac OS 8.5 installed. You can still create your custome trash icon replacement extension under Mac OS 8.0, but you need to test it under Mac OS 8.5 anyway. So, please use Mac OS 8.5 system for the following steps.
How to make your original trash icons?
First of all, You use the iTrash extension included in the iTrashMaker archive as a base extension throughout the steps below:
Unlike the iTrash extension that has been released public, the iTrash in this archive has a functionality to play sound when the trash is being emptied. If you do not need the sound capabiliy, you may use iTrash that's not in this archive.
Step-1: Edit icon resources of iTrash with ResEdit
Open the iTrash with ResEdit and edit the following icon resources.
ICN#, icl4, icl8 Large (32x32 dots) icon resources
ics#, ics4, ics8 Small (16x16 dots) icon reosurces
For each icon resource, the one with ID #130 is for the empty trash icon and the one with ID #131 is for the full trash icon. Please edit them and make your custom trash.
When you have finished editing the trash icon resources, please save your work and quit the ResEdit.
*NOTE-1*
iTrash also contains icns resource. Please do not touch this resource as the iTrashMaker need this resource to work properly.
*NOTE-2*
All the icon resources has the Sytem Heap attribute bits ON. Please do not change them or it will not work properly.
You need to be careful when you copy the custom icon from other resource file. Make sure that the System Heap bit of the icon resources are ON.
Step-2: Use iTrashMaker
Now you have edited icon resources of iTrash. Let's have iTrashMaker work and create the icns resource from the resources you have edited. Just double-click on the iTrashMaker icon and start the program. The file open dialog appears on the screen. Then, select the iTrash you have just edited and click on the OK button.
When iTrashMaker completed it's job successfully, you will see the dialog with the message "icns resources are successfully created". If not, then you might have screwed up something. Please read this document again to see what's wrong.
Step-3: Add sound resource (option)
iTrash has a capability of playing sound when the trash is being emptied. However, iTrash extension does not contain any sound resource. If you want to have it play sound, you need to add a sound resource to the iTrash extension. If you don't want to play any sound, just skip this section and go to the next step.
The sound resource should be 'snd ' resource ID #128. By default, iTrash assign about 16KB of system heap for the sound resource. If you want to add the sound resource bigger than 16KB, you also need to modify the sysz resource to expand the system heap allocation size. Please set the value of sysz resource bigger than the size of the sound resource + 16KB. (If the sound resource is 20KB, put 36KB to the sysz resource) When you add sound resource, make sure that you set the System Heap bit of the sound resource attribute to ON like other icon resources. Otherwise, it will cause the problem.
Step-4: Change other resources
If you release your new trash extension to public, you must change the name and icon of the extension to anything other than iTrash and ITr1 creator. Open the BNDL resource and change the creator to the one that is unique and noone is using. Please check Apple computer www site regarding registering your unique file creator.
Again, do not use the name iTrash and ITr1 creator for your new trash extension when you release your new trash extension to public.
Step-5: Prepair for the public release of your trash icon extension
Before releasing your new trash extension to public, you are required to do the following steps:
1. Add the following sentense and copyright credit to your Home Page (download page of your new trash extension) Read Me document enclosed in the archive of the new trash extension.
xxxx (the name of your new trash extension) is created using iTrashMaker and based on iTrash extension.
iTrash is created based on Flash Trash extension by Takuji Matsubara.
iTrash Copyright (c) 1998 by Hide Itoh <hide@kagi.com> All rights reserved.
iTrashMaker Copyright (c) 1998 by Hide Itoh <hide@kagi.com> All rights reserved.
Flash Trash Copyright (c) 1997 by Takuji Matsubara. All rights reserved.
2. Add the sentense that Hide Itoh and Takuji Matsubara has no responsibility to any damage or problems caused by the use of your new trash extension as a disclaimer in your Read Me document.
Important Note
Do not send me an email to ask how to use iTrashMaker
If you read this document completely and follow the above steps, iTrashMaker should work fine as well as the new iTrash extension. Please do not send me emails to ask something like 'It did not work....' 'What my iTrash does not work...'. I will not answer any questions regarding of using iTrashMaker and making your custome iTrash.
Of course, your comment are always welcome.
You can not use 32-bit icon for your own iTrash
It may work fine, but I have never tested and I will not test it. Since the standard trash icons with Mac OS 8.5 still uses 8-bit icon resource (with 8-bit deep mask), iTrashMaker does not support 32-bit icons.
iTrashMaker automatically creates 8-bit deep mask
Since iTrashMaker automatically creates 8-bit deep mask based on the 1-bit icon mask in the ICN# and ics# resources, you can not take the advantage of 8-bit deep mask. If you want to make full use of 8-bit deep mask for your trash icons, edit the s8mk and l8mk sub-resource in the icns resource manually or use other tool to edit them.
Version-up History
1.0 Nov 27, 1998
Original release (maybe this is the first and last release)
Disclaimer
While the author of this software has made every effort to deliver a high quality product, the author does not guarantee that this product is free from defects. The author is not responsible for any damage to the purchaser's computer system or data and in no event will I be responsible to the purchaser for any consequential, incidental, or indirect damages (including but not limited to damages for loss of business profits, business interruption, or loss of data) arising out of the use or inability to use this product, even if I have been advised of the possibility of such damages. Because some states do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitations may not apply to you. The use of this software includes the complete agreement of this disclaimer.
